home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / grabb387.arc / CONVERT.DOC < prev    next >
Text File  |  1991-08-12  |  18KB  |  382 lines
  1.  
  2.  
  3.                      GR2GIF (tm)
  4.                                     GR2PCX (tm)
  5.                                                    GR2PIC (tm)
  6.  
  7.                                      *********
  8.  
  9.                       Graphics Conversion Utilities for use with
  10.                        the GRABBER (tm) Screen Capture Program
  11.  
  12.                                    DOCUMENTATION
  13.                                     May 10, 1991
  14.  
  15.                                  Copyright 1991 by
  16.  
  17.                                   Gerald A. Monroe
  18.                                    1241 Bunts Road
  19.                               Lakewood, Ohio 44107  U.S.A.
  20.  
  21.                             CompuServe Mail ID # 72321,1257
  22.  
  23.  
  24.           YOUR LICENSE TO USE THIS SOFTWARE
  25.           ----------------------------------
  26.  
  27.           GR2GIF.COM, GR2PCX.COM, GR2PIC.COM and this documentation are
  28.           Copyright 1991 by Gerald A. Monroe.  All rights are reserved
  29.           except those expressly granted here.
  30.  
  31.           The programs GR2GIF, GR2PCX and GR2PIC, and this documentation file,
  32.           are distributed as an integral part of the GRABBER (tm) screen capture
  33.           package under the terms of a shareware license that is fully set forth
  34.           in the file GRABBER.DOC, which is the instruction manual for GRABBER
  35.           .COM, the main program module in the package.
  36.  
  37.           The shareware license terms in the GRABBER.DOC file are incorporated
  38.           here by reference.  This license permits you to copy and distribute
  39.           the files GR2GIF.COM, GR2PCX.COM, GR2PIC.COM and CONVERT.DOC (this
  40.           file) freely, provided that:  these files are always distributed
  41.           together with each other and with the GRABBER.EXE and GRABBER.DOC
  42.           files; none of the files is modified in any way; and no fee, premium
  43.           or donation of any kind is charged or requested for their distribu-
  44.           tion except as permitted on the terms described in the GRABBER.DOC
  45.           file.
  46.  
  47.           Continued use of the GR2GIF, GR2PCX or GR2PIC programs for more than
  48.           a 10-day trial period requires you to register your use of the soft-
  49.           ware with the author.  For more information about the benefits of
  50.           registration and how to go about registering, please refer to the
  51.           full licensing and ordering information in the GRABBER.DOC file.
  52.  
  53.  
  54.  
  55.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 2 of 7
  56.  
  57.  
  58.  
  59.  
  60.           WHAT ARE GR2GIF, GR2PCX and GR2PIC?
  61.           ------------------------------------
  62.  
  63.           GR2GIF, GR2PCX and GR2PIC are companion utilities to the GRABBER
  64.           screen capture program.  You can use them to convert graphic images,
  65.           captured from your video display in the form of GRABBER "offspring"
  66.           files, into any of three widely recognized generic image formats
  67.           called GIF, PCX and PIC.
  68.  
  69.           (If you are unfamiliar with how the GRABBER program works, or
  70.           what a GRABBER offspring file is, please consult the program
  71.           manual GRABBER.DOC before continuing.)
  72.  
  73.  
  74.  
  75.  
  76.           ABOUT THIS DOCUMENTATION
  77.           -------------------------
  78.  
  79.           These three GRABBER companion utilities are described together in
  80.           this one document because each is operated identically to the others.
  81.           The only difference between these programs is in the structure of the
  82.           files they create.
  83.  
  84.           For this reason, and for the sake of simplicity, the command examples
  85.           which are used in this document make use of the GR2GIF.COM program
  86.           exclusively.  GR2GIF creates GIF files from GRABBER offspring files.
  87.           If you want to create a PCX file with GR2PCX, or a PIC file using
  88.           GR2PIC, then you can substitute the appropriate program name wherever
  89.           the examples below refer to GR2GIF.
  90.  
  91.           Instructions for using these programs are detailed below, beginning
  92.           on page 5.  Briefly, you tell GR2GIF/PCX/PIC the name of the GRABBER
  93.           offspring file you wish to convert, and (optionally) the name of the
  94.           file to which to save the GIF/PCX/PIC rendition of your original
  95.           offspring file.  The program then goes to work, extracting the binary
  96.           screen image information from the offspring file, encoding it in the
  97.           appropriate format, and saving the results to the second file.
  98.  
  99.  
  100.  
  101.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 3 of 7
  102.  
  103.  
  104.  
  105.           THE "GIF" FILE FORMAT
  106.           ----------------------
  107.  
  108.           "GIF" is pronounced like "Jif," and it stands for "Graphic Interchange
  109.           Format."
  110.  
  111.           The GIF image format was developed by CompuServe, Inc., as a
  112.           generalized method of exchanging and displaying graphic images on
  113.           the widest possible variety of computer graphics hardware.  GIF is
  114.           probably the most widely accepted format for exchanging graphics
  115.           information among all makes and models of microcomputers, whether
  116.           IBM-compatible or not.  If there is a "standard," then GIF is it.
  117.           One of the reasons for the popularity of the GIF format is its
  118.           very effective data compression method.  Generally, there is no
  119.           other widely used file format which can compress a graphic image
  120.           into a smaller space than GIF can.
  121.  
  122.           The GIF format is supported extensively on the CompuServe Information
  123.           Service and many other on-line BBS services that make graphic images
  124.           available for downloading.  In addition to these on-line services,
  125.           however, there are several PC application programs which can employ
  126.           the GIF format.  These include word processing, desktop publishing,
  127.           and "paint" programs, as well as numerous picture viewing utilities.
  128.           Therefore, you can use GR2GIF to convert almost any graphic image
  129.           captured by GRABBER into GIF format, so that the image can be imported
  130.           into any word processing, desktop publishing, or paint program which
  131.           "understands" the GIF format.  If you want to find out whether a
  132.           particular application program you use can work with GIF files, and
  133.           therefore import the files created by GR2GIF, you should consult that
  134.           program's documentation or contact its publisher.
  135.  
  136.  
  137.           THE "PCX" FILE FORMAT
  138.           ----------------------
  139.  
  140.           The PCX image format was developed by Zsoft Corporation, which is the
  141.           publisher of the widely used graphics "paint" programs PC Paintbrush
  142.           and Publisher's Paintbrush.  Both of these programs use the PCX format
  143.           for storing and retrieving graphic images to and from disk files.
  144.           However, many other PC applications which involve graphic data, in
  145.           addition to the two Zsoft products mentioned, also employ the PCX
  146.           format.  These include other paint programs, word processors such as
  147.           WordPerfect Version 5.0 and above, desktop publishing programs, and
  148.           picture viewing utilities.  The PCX format uses a data compression
  149.           scheme to reduce the disk space required to store graphic images.
  150.           You can use GR2PCX to convert almost any graphic image captured by
  151.           GRABBER into PCX format, so that the image can be imported into any
  152.           word processing, desktop publishing, or paint program which "under-
  153.           stands" the PCX format.  If you want to find out whether a particular
  154.           application program you use can work with PCX files, and therefore
  155.           import the files created by GR2PCX, you should consult that program's
  156.           documentation or contact its publisher.
  157.  
  158.  
  159.  
  160.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 4 of 7
  161.  
  162.  
  163.  
  164.           THE "PIC" FILE FORMAT
  165.           ----------------------
  166.  
  167.           The PIC image format resembles the PCX format in its origins as a
  168.           method of storing "paint" program images.  The PIC format is employed
  169.           by such programs as EGA Paint, PC Paint and PC Paint Plus, and the
  170.           PICTOR and GRASP programs, as well as other paint programs.  Like GIF
  171.           and PCX, the PIC format uses a unique data compression scheme to save
  172.           disk space.  You can use GR2PIC to convert almost any graphic image
  173.           captured by GRABBER into the PIC format, so that the image can be
  174.           imported into any word processing, desktop publishing, or paint
  175.           program which "understands" the PIC format.  If you want to find out
  176.           whether a particular application program you use can work with PIC
  177.           files, you should consult that program's documentation or contact its
  178.           publisher.
  179.  
  180.  
  181.  
  182.           WHAT GR2GIF/PCX/PIC CAN CONVERT
  183.           --------------------------------
  184.  
  185.           These programs are able to convert almost any GRABBER offspring file
  186.           containing a graphic image into a separate GIF, PCX or PIC file.
  187.           This includes any image originally captured in any CGA mode, any EGA
  188.           mode, any VGA mode, and the Hercules monochrome graphics mode.
  189.  
  190.           These programs cannot be used to convert text-mode images to GIF,
  191.           PCX or PIC files.
  192.  
  193.           On page 4 of the GRABBER program documentation, there is a list of
  194.           the various video modes which GRABBER supports.  If a video mode
  195.           in that chart indicates "n/a" in the column which is headed "Graphics
  196.           Resolution," then that is a text mode, and GRABBER offspring files
  197.           captured in that mode cannot be converted to GIF, PCX or PIC.  The
  198.           other modes shown there can be converted.
  199.  
  200.           Note for the technical-oriented user:  If you have a Super-VGA (SVGA)
  201.           adapter, you should read page 5 of the GRABBER program documenta-
  202.           tion.  Generally, any 16-color or 256-color SVGA image can be con-
  203.           verted to the GIF, PCX and PIC formats using these programs if the
  204.           SVGA manufacturer has modeled the memory organization of its video
  205.           modes after the IBM EGA "four-plane planar" method (for 16-color
  206.           screens), or IBM VGA "packed pixel" method (for 256-color screens).
  207.           SVGA memory organization schemes which are unique to certain adapters
  208.           are generally not supported by these conversion programs.  An example
  209.           of such a mode is the one numbered 67h for 1,024 x 768 16-color
  210.           images on the ATI VGA Wonder adapter.
  211.  
  212.  
  213.  
  214.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 5 of 7
  215.  
  216.  
  217.           USING GR2GIF/PCX/PIC : INTERACTIVE MODE
  218.           ----------------------------------------
  219.  
  220.           First, choose a GRABBER offspring image you want to convert.  The
  221.           offspring file must contain a graphic image.
  222.  
  223.           From the DOS prompt (or in a batch file), enter the command GR2GIF
  224.           and press <RETURN>.  The program asks you to specify the name of the
  225.           offspring file you wish to convert (the "input file").  You may
  226.           optionally precede the filename with a drive and/or pathname if
  227.           necessary.
  228.  
  229.           (Note:  All GRABBER offspring files should have the file extension
  230.           ".EXE", and these conversion programs assume that your input file
  231.           ends in ".EXE".  You may omit this extension when entering the
  232.           file name.  For example, entering "SCREENXX" is the same as enter-
  233.           ing "SCREENXX.EXE".)
  234.  
  235.           Next, the program asks for the name of the file you wish to create
  236.           from the offspring image (the "output file").  If you wish to give
  237.           your output file the same name as your input file but with a ".gif"
  238.           (or ".pcx" or ".pic") extension, just press <RETURN>.  If you wish
  239.           to give it a different name than the default which the program shows
  240.           you, or place it in a different drive or directory than your input
  241.           file, you must enter the full file specification, including drive,
  242.           path, and ".gif" extension.
  243.  
  244.           (NOTE:  Do not give the output file an ".EXE" or ".COM" extension.
  245.           GIF, PCX and PIC files are not executable programs like the original
  246.           offspring file, and attempting to execute them like one will certainly
  247.           "crash" your computer.)
  248.  
  249.           Finally, the program asks if you want to "resize" the image.  If you
  250.           respond by pressing <N> or <RETURN>, then the program will convert the
  251.           entire image to GIF, PCX or PIC format.  The resulting file will in-
  252.           clude image data for the entire screen as it appears on your display
  253.           when you execute the .EXE offspring file.
  254.  
  255.           If you don't want to convert the entire image to GIF, PCX or PIC
  256.           format, but wish to convert only a portion of it, then you should
  257.           respond to the "resize" prompt by pressing <Y>.  GR2GIF will display
  258.           the offspring image on your screen along with a highlighted "select
  259.           box," which you use to tell the program which rectangular portion of
  260.           the image to save to GIF, PCX or PIC format.  Instructions for moving
  261.           the select box around the screen, and changing its size or shape, can
  262.           be found below on page 6.
  263.  
  264.           After you respond to the "resize" prompt by pressing <N> or <RETURN>,
  265.           or finish resizing the image (if you pressed <Y>), the program goes
  266.           to work, creating your output file from the original offspring.  This
  267.           usually takes only a few seconds.  When the program is finished
  268.           creating your output file, it displays a message to this effect.  This
  269.           newly created GIF, PCX or PIC file is now ready for you to use.
  270.  
  271.  
  272.  
  273.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 6 of 7
  274.  
  275.  
  276.  
  277.           USING THE RESIZE FEATURE:  CONTROLLING THE SELECT BOX
  278.           ------------------------------------------------------
  279.  
  280.           The following keys are available to you when using the resize feature
  281.           feature within GR2GIF, GR2PCX and GR2PIC:
  282.  
  283.           <Esc> . . . . . . . . . . . .  Abort the conversion process and exit.
  284.  
  285.           <Return>  . . . . . . . . . .  Accept the area enclosed by the select
  286.                                          box, and begin converting.
  287.  
  288.           <Left Arrow>
  289.           <Right Arrow>                  Move the select box in the indicated
  290.           <Up Arrow>                     direction without changing the shape
  291.           <Down Arrow>  . . . . . . . .  of the box.
  292.  
  293.           <Shift><Left Arrow> . . . . .  Shrink the box horizontally.
  294.  
  295.           <Shift><Right Arrow>  . . . .  Expand the box horizontally.
  296.  
  297.           <Shift><Up Arrow> . . . . . .  Shrink the box vertically.
  298.  
  299.           <Shift><Down Arrow> . . . . .  Expand the box vertically.
  300.  
  301.           <Insert>  . . . . . . . . . .  Toggle between coarse and fine incre-
  302.                                          ments for moving or reshaping the box.
  303.  
  304.           <Home>  . . . . . . . . . . .  Move the box to the upper left-hand
  305.                                          corner of the screen.
  306.  
  307.           <End> . . . . . . . . . . . .  Move the box to the lower left-hand
  308.                                          corner of the screen.
  309.  
  310.           <Ctrl><PgUp>  . . . . . . . .  Move the box to the upper right-hand
  311.                                          corner of the screen.
  312.  
  313.           <Ctrl><PgDn>  . . . . . . . .  Move the box to the lower right-hand
  314.                                          corner of the screen.
  315.  
  316.           <PgUp>  . . . . . . . . . . .  Move box to top edge of the screen.
  317.  
  318.           <PgDn>  . . . . . . . . . . .  Move box to bottom edge of the screen.
  319.  
  320.           <Ctrl><Left Arrow>  . . . . .  Move box to left edge of the screen.
  321.  
  322.           <Ctrl><Right Arrow> . . . . .  Move box to right edge of the screen.
  323.  
  324.  
  325.  
  326.           GR2GIF /GR2PCX /GR2PIC  Documentation                      Page 7 of 7
  327.  
  328.  
  329.  
  330.           USING GR2GIF/PCX/PIC :  COMMAND LINE MODE
  331.           ------------------------------------------
  332.  
  333.           You can also run the conversion programs by placing both the input
  334.           (offspring) and output (GIF, PCX or PIC) filenames on the DOS command
  335.           line after the program name itself.  Use this example:
  336.  
  337.  
  338.           GR2GIF [d:][\path\]SCREENXX[.EXE] [d:][\path\][SCREENXX.GIF] [/S]
  339.  
  340.  
  341.           The parameters shown within [brackets] are optional.
  342.  
  343.           To use the resize option (described above) in command-line mode,
  344.           include the /S switch on the GR2GIF command line.  If you omit
  345.           the /S switch, the entire image will be converted to GIF format.
  346.  
  347.           The first [d:] stands for the disk drive where your offspring
  348.           program file is located, and the first [\path\] stands for the
  349.           directory in which it resides.  In the above example, SCREENXX.EXE
  350.           is the name of the GRABBER offspring file containing the image you
  351.           want to convert.  As above, ".EXE" extensions may be omitted.
  352.  
  353.           The second [d:] and [\path\] stand for the drive and directory in
  354.           which to place your converted output file.  If you omit the output
  355.           filename, the program will supply a default for you, and create your
  356.           GIF/PCX/PIC file on the same drive and directory as your input file,
  357.           giving it the same name as the input file but with a ".gif" (or ".pcx"
  358.           or ".pic") extension in place of the ".EXE".
  359.  
  360.           Another example.  Entering:
  361.  
  362.              GR2GIF C:\PICTURES\SCREEN00 /S
  363.  
  364.           has the same effect as entering:
  365.  
  366.              GR2GIF C:\PICTURES\SCREEN00.EXE C:\PICTURES\SCREEN00.GIF /S
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.                             **  End of CONVERT.DOC  **
  382.